// =============================================================================
// | 包: site                                                                  |
// | 模块: 站点子配置                                                         |
// | 功能: 定义站点配置的各个子模块结构体                                      |
// =============================================================================
package site

// =============================================================================
// | 结构体: SiteInfo                                                          |
// | 功能: 站点基本信息结构体                                                  |
// | 用途: 存储网站的核心标识信息                                              |
// =============================================================================
type SiteInfo struct {
	// =============================================================================
	// | 字段: Title - string                                                       |
	// | 功能: 站点标题                                                           |
	// | 映射: YAML配置中的site.title字段                                          |
	// =============================================================================
	Title string `yaml:"title" json:"title"` // 站点标题 - 网站的主要标题
	
	// =============================================================================
	// | 字段: Logo - string                                                       |
	// | 功能: 站点Logo                                                           |
	// | 映射: YAML配置中的site.logo字段                                           |
	// =============================================================================
	Logo string `yaml:"logo" json:"logo"` // 站点Logo - 网站标识图片
	
	// =============================================================================
	// | 字段: Beian - string                                                      |
	// | 功能: 备案信息                                                           |
	// | 映射: YAML配置中的site.beian字段                                          |
	// =============================================================================
	Beian string `yaml:"beian" json:"beian"` // 备案信息 - 网站备案号
	
	// =============================================================================
	// | 字段: Mode - int8                                                         |
	// | 功能: 站点模式                                                           |
	// | 映射: YAML配置中的site.mode字段                                           |
	// =============================================================================
	Mode int8 `yaml:"mode" json:"mode"` // 站点模式 - 1 社区模式 2 博客模式
}

// =============================================================================
// | 结构体: Project                                                           |
// | 功能: 项目信息结构体                                                      |
// | 用途: 存储项目相关的配置信息                                              |
// =============================================================================
type Project struct {
	// =============================================================================
	// | 字段: Title - string                                                      |
	// | 功能: 项目标题                                                           |
	// | 映射: YAML配置中的project.title字段                                       |
	// =============================================================================
	Title string `yaml:"title" json:"title"` // 项目标题 - 项目展示名称
	
	// =============================================================================
	// | 字段: Icon - string                                                       |
	// | 功能: 项目图标                                                           |
	// | 映射: YAML配置中的project.icon字段                                        |
	// =============================================================================
	Icon string `yaml:"icon" json:"icon"` // 项目图标 - 项目展示图标
	
	// =============================================================================
	// | 字段: WebPath - string                                                    |
	// | 功能: 项目网页路径                                                       |
	// | 映射: YAML配置中的project.webPath字段                                     |
	// =============================================================================
	WebPath string `yaml:"webPath" json:"webPath"` // 网页路径 - 项目的访问路径
}

// =============================================================================
// | 结构体: Seo                                                               |
// | 功能: SEO配置结构体                                                      |
// | 用途: 存储搜索引擎优化相关配置                                            |
// =============================================================================
type Seo struct {
	// =============================================================================
	// | 字段: Keywords - string                                                   |
	// | 功能: 站点关键词                                                         |
	// | 映射: YAML配置中的seo.keywords字段                                        |
	// =============================================================================
	Keywords string `yaml:"keywords" json:"keywords"` // 关键词 - 用于SEO优化的关键词
	
	// =============================================================================
	// | 字段: Description - string                                                |
	// | 功能: 站点描述                                                           |
	// | 映射: YAML配置中的seo.description字段                                     |
	// =============================================================================
	Description string `yaml:"description" json:"description"` // 描述 - 网站的简短介绍
}

// =============================================================================
// | 结构体: About                                                             |
// | 功能: 关于站点信息结构体                                                  |
// | 用途: 存储站点的联系信息和社交媒体账号                                    |
// =============================================================================
type About struct {
	// =============================================================================
	// | 字段: SiteDate - string                                                  |
	// | 功能: 站点建立日期                                                       |
	// | 映射: YAML配置中的about.siteDate字段                                      |
	// =============================================================================
	SiteDate string `yaml:"siteDate" json:"siteDate"` // 站点建立日期 - 年月日格式
	
	// =============================================================================
	// | 字段: QQ - string                                                          |
	// | 功能: QQ联系方式                                                         |
	// | 映射: YAML配置中的about.qq字段                                             |
	// =============================================================================
	QQ string `yaml:"qq" json:"qq"` // QQ - QQ联系方式
	
	// =============================================================================
	// | 字段: Wechat - string                                                      |
	// | 功能: 微信联系方式                                                       |
	// | 映射: YAML配置中的about.wechat字段                                         |
	// =============================================================================
	Wechat string `yaml:"wechat" json:"wechat"` // 微信 - 微信联系方式
	
	// =============================================================================
	// | 字段: Gitee - string                                                      |
	// | 功能: Gitee链接                                                          |
	// | 映射: YAML配置中的about.gitee字段                                         |
	// =============================================================================
	Gitee string `yaml:"gitee" json:"gitee"` // Gitee - Gitee项目地址
	
	// =============================================================================
	// | 字段: Bilibili - string                                                    |
	// | 功能: Bilibili链接                                                        |
	// | 映射: YAML配置中的about.bilibili字段                                       |
	// =============================================================================
	Bilibili string `yaml:"bilibili" json:"bilibili"` // Bilibili - Bilibili账号
	
	// =============================================================================
	// | 字段: Github - string                                                      |
	// | 功能: GitHub链接                                                         |
	// | 映射: YAML配置中的about.github字段                                         |
	// =============================================================================
	Github string `yaml:"github" json:"github"` // GitHub - GitHub项目地址
}

// =============================================================================
// | 结构体: Login                                                             |
// | 功能: 登录方式配置结构体                                                  |
// | 用途: 存储各类登录方式的开关配置                                          |
// =============================================================================
type Login struct {
	// =============================================================================
	// | 字段: QQLogin - bool                                                      |
	// | 功能: QQ登录开关                                                         |
	// | 映射: YAML配置中的login.qqLogin字段                                        |
	// =============================================================================
	QQLogin bool `yaml:"qqLogin" json:"qqLogin"` // QQ登录 - 是否开启QQ登录
	
	// =============================================================================
	// | 字段: UsernamePwdLogin - bool                                             |
	// | 功能: 用户名密码登录开关                                                 |
	// | 映射: YAML配置中的login.usernamePwdLogin字段                               |
	// =============================================================================
	UsernamePwdLogin bool `yaml:"usernamePwdLogin" json:"usernamePwdLogin"` // 用户名密码登录 - 是否开启用户名密码登录
	
	// =============================================================================
	// | 字段: EmailLogin - bool                                                   |
	// | 功能: 邮箱登录开关                                                       |
	// | 映射: YAML配置中的login.emailLogin字段                                     |
	// =============================================================================
	EmailLogin bool `yaml:"emailLogin" json:"emailLogin"` // 邮箱登录 - 是否开启邮箱登录
	
	// =============================================================================
	// | 字段: Captcha - bool                                                      |
	// | 功能: 验证码开关                                                         |
	// | 映射: YAML配置中的login.captcha字段                                        |
	// =============================================================================
	Captcha bool `yaml:"captcha" json:"captcha"` // 验证码 - 是否开启登录验证码
}

// =============================================================================
// | 结构体: ComponentInfo                                                     |
// | 功能: 组件信息结构体                                                      |
// | 用途: 存储组件的基本信息                                                  |
// =============================================================================
type ComponentInfo struct {
	// =============================================================================
	// | 字段: Title - string                                                      |
	// | 功能: 组件标题                                                           |
	// | 映射: YAML配置中的componentInfo.title字段                                  |
	// =============================================================================
	Title string `yaml:"title" json:"title"` // 组件标题 - 组件的显示名称
	
	// =============================================================================
	// | 字段: Enable - bool                                                      |
	// | 功能: 组件启用状态                                                       |
	// | 映射: YAML配置中的componentInfo.enable字段                                  |
	// =============================================================================
	Enable bool `yaml:"enable" json:"enable"` // 启用状态 - 是否启用该组件
}

// =============================================================================
// | 结构体: IndexRight                                                        |
// | 功能: 首页右侧组件配置结构体                                              |
// | 用途: 存储首页右侧组件列表                                                |
// =============================================================================
type IndexRight struct {
	// =============================================================================
	// | 字段: List - []ComponentInfo                                              |
	// | 功能: 组件列表                                                           |
	// | 映射: YAML配置中的indexRight.list字段                                      |
	// =============================================================================
	List []ComponentInfo `yaml:"list" json:"list"` // 组件列表 - 首页右侧显示的组件列表
}

// =============================================================================
// | 结构体: Article                                                           |
// | 功能: 文章配置结构体                                                      |
// | 用途: 存储文章相关的配置信息                                              |
// =============================================================================
type Article struct {
	// =============================================================================
	// | 字段: NoExamine - bool                                                    |
	// | 功能: 免审核开关                                                         |
	// | 映射: YAML配置中的article.noExamine字段                                    |
	// =============================================================================
	NoExamine bool `yaml:"noExamine" json:"noExamine"` // 免审核 - 是否开启文章免审核功能
}
